home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / getmntinfo.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  49 lines
  1.  
  2. GETMNTINFO(3)              UNIX Programmer's Manual              GETMNTINFO(3)
  3.  
  4. NNAAMMEE
  5.      ggeettmmnnttiinnffoo - get information about mounted file systems
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  9.      ##iinncclluuddee <<ssyyss//uuccrreedd..hh>>
  10.      ##iinncclluuddee <<ssyyss//mmoouunntt..hh>>
  11.  
  12.      _i_n_t
  13.      ggeettmmnnttiinnffoo(_s_t_r_u_c_t _s_t_a_t_f_s _*_*_m_n_t_b_u_f_p, _i_n_t _f_l_a_g_s)
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      The ggeettmmnnttiinnffoo() function returns an array of statfs structures describ-
  17.      ing each currently mounted file system (see statfs(2)).
  18.  
  19.      The ggeettmmnnttiinnffoo() function passes its _f_l_a_g_s parameter transparently to
  20.      getfsstat(2).
  21.  
  22. RREETTUURRNN VVAALLUUEESS
  23.      On successful completion, ggeettmmnnttiinnffoo() returns a count of the number of
  24.      elements in the array.  The pointer to the array is stored into _m_n_t_b_u_f_p.
  25.  
  26.      If an error occurs, zero is returned and the external variable _e_r_r_n_o is
  27.      set to indicate the error.  Although the pointer _m_n_t_b_u_f_p will be unmodi-
  28.      fied, any information previously returned by ggeettmmnnttiinnffoo() will be lost.
  29.  
  30. EERRRROORRSS
  31.      The ggeettmmnnttiinnffoo() function may fail and set _e_r_r_n_o for any of the errors
  32.      specified for the library routines getfsstat(2) or malloc(3).
  33.  
  34. SSEEEE AALLSSOO
  35.      getfsstat(2),  statfs(2),  mount(2),  mount(8)
  36.  
  37. HHIISSTTOORRYY
  38.      The ggeettmmnnttiinnffoo() function first appeared in 4.4BSD.
  39.  
  40. BBUUGGSS
  41.      The ggeettmmnnttiinnffoo() function writes the array of structures to an internal
  42.      static object and returns a pointer to that object. Subsequent calls to
  43.      ggeettmmnnttiinnffoo() will modify the same object.
  44.  
  45.      The memory allocated by ggeettmmnnttiinnffoo() cannot be free(2)'d  by the applica-
  46.      tion.
  47.  
  48. BSD Experimental                 June 9, 1993                                1
  49.